home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / host41.arc / GATEWAY2.DOC next >
Text File  |  1990-02-13  |  13KB  |  268 lines
  1.  
  2.   ******
  3.  ********    ****    ********  ********                       ****   ***    ***
  4.  **    **   **  **   ********  **    **  ***           ***   **  **   ***  ***
  5.  **        **    **     **     **        ***           ***  **    **   ******
  6.  **   ***  **    **     **     *****      ***    *    ***   **    **    ****
  7.  **    **  ********     **     **          ***  ***  ***    ********    ***
  8.  ********  **    **     **     **    **     ***********     **    **   ***
  9.   ******   **    **     **     ********      ***   ***      **    **  ***
  10.  
  11.  
  12.           GATEWAY (c) version 2.00  -  July 1987 by Hans D. Kellner
  13.  
  14.  
  15.         Welcome to  Gateway and the  world of remote communications!  This
  16.     program has been written as a utility for System Operators (Sysops) of
  17.     bulletin boards.  It is now possible to run an external program and be
  18.     able to control and see the program, even if the program uses the ANSI
  19.     control codes.  Input is taken  from the COM line and system keyboard.
  20.     Output is  sent to  the system  screen and out  through  the COM line.
  21.     Several new features have  been added to version 2.00 of Gateway.  The
  22.     most important  is the  support of a Fossil  driver  for input/output.
  23.     Also, the program is now  one file that is installed with command line
  24.     arguments.  A  few other changes  have been  added which are explained
  25.     below.  Now enough chatter...  go on to the good stuff!
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                              SYSTEM REQUIREMENTS
  34.                              -------------------
  35.  
  36.         Gateway has been  written in  assembly language as a DOS character
  37.     device  driver.  When loaded,  it only  requires a  little  over 2K of
  38.     memory.  It may be run on an IBM PC or compatible using PC/MS DOS.  If
  39.     the Fossil driver option is used  the program is less dependent on the
  40.     hardware.  When the  Fossil option is  specified all COM  input/output
  41.     and keyboard input is done through the  Fossil.  If direct port writes
  42.     are used, COM input/output is done with direct read/writes to the 8250
  43.     UART chip.   Also, keyboard  input will be done through BIOS call 16H.
  44.     In  both  options, screen  output  is done  through BIOS call 10H.  If
  45.     you  have installed  Gateway  with the  Fossil option,  then a  Fossil
  46.     driver  must be loaded  before  Gateway may be used.  Two drivers that
  47.     have been tested with Gateway are X00 by Ray Gwinn and OPUS!COM by Bob
  48.     Hartman.  Other Fossil  drivers may work with  Gateway as long as they
  49.     implement the same functions.  I used Vincent E. Perriello's document,
  50.     'Fundamentals of  FOSSIL  implementation  and use',  Draft  version 3,
  51.     March 7, 1987.   Gateway determines  the UART  port  address from  the
  52.     RS_232_BASE table.  This is located  in the BIOS data  area at address
  53.     0040:0000.  Gateway only  does this when  the Direct  write option has
  54.     been specified.  Enough tech stuff...
  55.  
  56.  
  57.  
  58.  
  59.                               CHANGES & ADDITIONS
  60.                               -------------------
  61.  
  62.         With the release of  version 2.00 of  Gateway several changes have
  63.     been made.  The most important addition is the ability to use a Fossil
  64.     driver for input/ouput.  This makes Gateway very generic.  The program
  65.     is  now one file that is  configured with command line arguments.  The
  66.     support of COM1 through COM4 has been added.  Tabs are expanded on the
  67.     system screen.  Some of the code  has been optimized  ( but I doubt if
  68.     you will notice ).  That is all I can think of at the moment...
  69.  
  70.  
  71.  
  72.                                  INSTRUCTIONS
  73.                                  ------------
  74.  
  75.         The Gateway program is  implemented as a device driver.  It should
  76.     be loaded  with  your CONFIG.SYS file.  An example line  from a CONFIG
  77.     file is shown below :
  78.  
  79.     DEVICE=[drive:][path\]Gateway.sys
  80.  
  81.         This example would load Gateway, defaulting to a Fossil driver for
  82.     input/output onto COM line 1. The configuration of Gateway may also be
  83.     changed with command line arguments. The arguments accepted are listed
  84.     below :
  85.  
  86.  
  87.                    -F           { Use Fossil driver (default)   }
  88.                    -D           { Use Direct port writes        }
  89.  
  90.                    -1           { Use COM line 1    (default)   }
  91.                    -2           { Use  '   '   2                }
  92.                    -3           { Use  '   '   3                }
  93.                    -4           { Use  '   '   4                }
  94.  
  95.  
  96.     If no arguments are given, Gateway will default to -F -1 (Fossil driver
  97.     on COM1).  The -F and -D  option are  mutually exclusive as are the COM
  98.     line  values.  These arguments are  included on  the line  used to load
  99.     Gateway.  Here are  several  examples that  could be  used in  your own
  100.     Config.sys file :
  101.  
  102.  
  103.     DEVICE=C:\GATEWAY.SYS -F -2         { Loads Gateway using Fossil    }
  104.                                         { driver for COM line 2         }
  105.  
  106.     DEVICE=B:\SYS\GATEWAY.SYS -4 -F     { Loads Gateway using Fossil    }
  107.                                         { driver for COM line 4         }
  108.  
  109.     DEVICE=C:\GATEWAY.SYS -D -2         { Loads Gateway using Direct    }
  110.                                         { port writes on COM line 2     }
  111.  
  112.     DEVICE=GATEWAY.SYS -D -3            { Load Gateway using Direct     }
  113.                                         { port writes on COM line 3     }
  114.  
  115.     The order of  the arguments does  not matter.  Drive and path are also
  116.     optional.  After Gateway is loaded, it determines what COM line it has
  117.     been  installed for.  It  then sets  its device  name according to the
  118.     line chosen.  The names for each line are shown below :
  119.  
  120.                         GATE1           { COM line 1 }
  121.                         GATE2           { COM line 2 }
  122.                         GATE3           { COM line 3 }
  123.                         GATE4           { COM line 4 }
  124.  
  125.     Simple and  original convention, eh?   This allows you to install more
  126.     than one  copy of  Gateway  for separate  COM lines.  A  note for PCjr
  127.     owners.  The external serial port should be addressed as COM1 when the
  128.     Internal Modem is  not installed.  When installed,  the Internal Modem
  129.     is addressed as COM1 and the external serial port as COM2.
  130.  
  131.         Once loaded,  the driver  may be  activated in two  possible ways.
  132.     The first method uses  the DOS command CTTY.  This command changes the
  133.     standard input  and output console.  An explanation of it may be found
  134.     in your DOS manual.  This command is  executed from the DOS prompt.  A
  135.     few example activations of Gateway are shown below :
  136.  
  137.  
  138.                 C>CTTY GATE1            { Make Gateway COM1 the standard }
  139.                                         { console driver.                }
  140.  
  141.                 A>CTTY GATE3            { Same as above except for a     }
  142.                                         { COM3 version of Gateway.       }
  143.  
  144.         This will  cause all standard i/o to be  directed through Gateway.
  145.     Notice that the  name after the CTTY command is the device name of the
  146.     Gateway  program.  When finished  using  Gateway, enter  the following
  147.     command at the prompt :
  148.  
  149.                                 CTTY CON
  150.  
  151.     When this is  entered, DOS will restore the screen and keyboard as the
  152.     standard input and output devices.
  153.  
  154.         The second  method for using the driver involves using the DOS i/o
  155.     re-direction  symbols.  These are  explained in  the DOS manual.  With
  156.     this method, the driver is only activated  during the execution of the
  157.     program being re-directed.  An example :
  158.  
  159.                         A>COMMAND < GATE2 > GATE2
  160.  
  161.     When this  command is  entered at the  DOS prompt, several things take
  162.     place. First, DOS determines  that all input and output will come from
  163.     Gateway (COM2).  Then, the second  Command processor  (COMMAND.COM) is
  164.     loaded.  Any  input  or output will  now be  sent through the  Gateway
  165.     driver.  The Sysop will also be able to see output and can enter input
  166.     from  the  keyboard.  When  the  user 'EXIT's  ( or Sysop ) the second
  167.     Command.com, DOS  will revert back to the  screen and  keyboard as the
  168.     input/output devices.
  169.  
  170.         Gateway may be  used for other applications.  Combine Gateway with
  171.     a  communication  program  and its  'Drop to DOS' feature.  Leave  the
  172.     program  in 'Host' mode, then access your computer remotely.  Now Drop
  173.     or  exit to DOS.  A  batch  file  you have created then  runs a second
  174.     Command.com and re-directs its i/o with  Gateway (example above).  You
  175.     now have control of your computer!
  176.  
  177.  
  178.                            NOTES : GOOD NEWS BAD NEWS
  179.                            --------------------------
  180.  
  181.         Only  programs that use  standard  DOS input/output  calls may  be
  182.     re-directed with Gateway.  Programs that use  BIOS i/o calls or direct
  183.     screen writes will not have their i/o re-directed.
  184.  
  185.         Gateway  will correctly display ANSI  control codes on the Sysop's
  186.     screen.  The user will  receive the codes untouched.  Not all the ANSI
  187.     codes have been implemented though. The ones not recognized by Gateway
  188.     are the following :
  189.  
  190.                           DSR - Device Status Report
  191.                           CPR - Cursor Position Report
  192.                           SM  - Set Mode
  193.                           RM  - Reset Mode
  194.                           KKR - Keyboard Key Reassignment
  195.  
  196.         A note to  programmers who plan to write programs for external BBS
  197.     use.  Gateway will  only re-direct output  sent through  DOS  standard
  198.     input/output calls.  I would suggest using the  ANSI control codes and
  199.     the standard  i/o calls. This way your program may effectively be used
  200.     with Gateway.
  201.  
  202.         Some programs  don't work  with the re-direction symbols but work
  203.     perfectly fine  with the CTTY command.  Experimentation is the key to
  204.     success.
  205.  
  206.        Gateway has  been tested  on the  OPUS Computer-Based Conversation
  207.     System, by Wynn Wagner III. It has also been used with several of the
  208.     popular  communications programs in  conjunction with their exit/jump
  209.     to DOS commands. It has been run successfully on an IBM PCjr, XT, AT,
  210.     and compatibles.
  211.  
  212.         PCjr owners  using the direct write  option should note the port
  213.     assignment convention.  The external serial port should be addressed
  214.     as COM1  when the Internal Modem is  not installed.  When installed,
  215.     the Internal Modem is addressed as COM1 and the external serial port
  216.     as COM2.
  217.  
  218.         The driver should not be activated when  there isn't a carrier on
  219.     the other  end of  the modem.  If  it is, a loop  back occurs and any
  220.     character output is  echoed by the modem and taken as input.  If this
  221.     occurs turn the modem off.  If the modem does not echo characters, or
  222.     is made not to,then the driver can be used when no carrier is present.
  223.  
  224.  
  225.  
  226.                                IMPORTANT STUFF
  227.                                ---------------
  228.  
  229.         This program is Public Domain!  It may be  used freely  by anyone
  230.     who does not  profit from  its use.  If you  profit from  MY  program
  231.     then please  send  me $5.00 in American currency.  You may contact me
  232.     at the location noted  at the end of this document.  Please feel free
  233.     to pass Gateway along to others, but you may not sell it. If you wish
  234.     to include  my program with  your software, please  contact me first.
  235.     This document must  be included with  the program file  (GATEWAY.SYS)
  236.     when distributed.
  237.  
  238.  
  239.  
  240.                                  DISCLAIMER
  241.                                  ----------
  242.  
  243.         This program is provided as is.  You may use it at your own risk.
  244.     There is no  warranty of  any kind or any form covering this program.
  245.     The author may in no way be held liable for any damage of any form in
  246.     connection  or arising from the  quality and/or  use of this  program
  247.     and any associated files included with it.
  248.  
  249.  
  250.  
  251.                                   CONTACT
  252.                                   -------
  253.  
  254.         Current versions of Gateway  may be downloaded from :
  255.         
  256.                             Corwin's Keep OPUS
  257.                              (FidoNet 114/13)
  258.                               (602)-894-1470
  259.                             300-1200-2400 Baud
  260.  
  261.         File requests are accepted.  If you wish to contact me, address
  262.     mail to  Hans Kellner through 114/13.   I regularly read the MEADOW
  263.     conference mail.  You may enter messages there or through NetMail.
  264.  
  265.  
  266.                                 Good Luck!
  267.  
  268.